home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / dev / gcc / ixemsdk.lha / man / cat3 / ungetc.0 < prev    next >
Text File  |  1996-09-02  |  2KB  |  40 lines
  1.  
  2. UNGETC(3)                  UNIX Programmer's Manual                  UNGETC(3)
  3.  
  4. NNAAMMEE
  5.      uunnggeettcc - un-get character from input stream
  6.  
  7. SSYYNNOOPPSSIISS
  8.      ##iinncclluuddee <<ssttddiioo..hh>>
  9.  
  10.      _i_n_t
  11.      uunnggeettcc(_i_n_t _c, _F_I_L_E _*_s_t_r_e_a_m)
  12.  
  13. DDEESSCCRRIIPPTTIIOONN
  14.      The uunnggeettcc() function pushes the character _c (converted to an unsigned
  15.      char) back onto the input stream pointed to by _s_t_r_e_a_m. The pushed-backed
  16.      characters will be returned by subsequent reads on the stream (in reverse
  17.      order).  A successful intervening call, using the same stream, to one of
  18.      the file positioning functions (fseek(3),  fsetpos(3),  or rewind(3))
  19.      will discard the pushed back characters.
  20.  
  21.      One character of push-back is guaranteed, but as long as there is suffi-
  22.      cient memory, an effectively infinite amount of pushback is allowed.
  23.  
  24.      If a character is successfully pushed-back, the end-of-file indicator for
  25.      the stream is cleared.
  26.  
  27. RREETTUURRNN VVAALLUUEESS
  28.      The uunnggeettcc() function returns the character pushed-back after the conver-
  29.      sion, or EOF if the operation fails.  If the value of the argument _c
  30.      character equals EOF, the operation will fail and the stream will remain
  31.      unchanged.
  32.  
  33. SSEEEE AALLSSOO
  34.      getc(3),  fseek(3),  setvbuf(3)
  35.  
  36. SSTTAANNDDAARRDDSS
  37.      The uunnggeettcc() function conforms to ANSI C3.159-1989 (``ANSI C'').
  38.  
  39. BSD Experimental                 June 4, 1993                                1
  40.